home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 1 / ACE CD 1.iso / files / utils / videot4.dms / in.adf / TreeGrow_Doc < prev    next >
Encoding:
Text File  |  1993-02-26  |  6.1 KB  |  201 lines
  1. TreeGrow V1.0          © 1992 by PARADISE SOFT      FREEWARE
  2.  
  3. ---------------------------------------------------------------------------
  4.  
  5.                   COPYRIGHT
  6.                   ¯¯¯¯¯¯¯¯¯
  7.  
  8. TreeGrow is FREEWARE, you can copy it to everyone as long as you don't take
  9. more than $5, 8DM or equivalent for the disk containing TreeGrow and all
  10. important files are included. These files are :
  11.  
  12.     Filename    size/bytes  discription
  13.     --------------------------------------------------------
  14.     libs (DIR)
  15.         ilbm.library      6920  used to save pictues ¹
  16.         req.library      18012  the filerequester ²
  17.         mathieeesingbas.library
  18.                   4868  used by DICE ³
  19.         mathieeesingtrans.library
  20.                  10428  used by DICE ³
  21.  
  22.     sources (DIR)
  23.         TreeGrow.c         29674  the C-source of TreeGrow
  24.         TreeGrowGadgets.h 6742  the gadget structures
  25.         TreeGrowGfx.h     4049  the graphics
  26.         ilbmLCglue.o      3436  glue for ilbm.library !
  27.         reqLCglue.o       1540  glue for req.library ²
  28.         MakeTree.sh     58  script to compile TreeGrow
  29.  
  30.     TreeGrow         33080  the program itself
  31.     TreeGrow.info           866
  32.     TreeGrow.doc          6257  this file
  33.     TreeGrow.doc.info     2567
  34.     TreeGrow.lib          ----  the TreeGrow library NO COPYRIGHT
  35.     InstallLibs           713  script to install libraries
  36.     InstallLibs.info      1012
  37.  
  38. All files are © by PARADISE SOFT except :
  39.     ¹ : © by Jeff Glatt
  40.     ² : © by Colin Fox and Bruce Dawson
  41.     ³ : © by Matthew Dillon
  42.  
  43. libs/mathieeedoubbas.library and
  44. libs/mathieeedoubtrabs.library from your WorkBench are needed, too.
  45.  
  46. TreeGrow was compiled with DICE 2.06.40 © by Matthew Dillon.
  47.  
  48. I'am not resonsible for any damages caused by TreeGrow.
  49.  
  50. You are not allowed to release any changed versions of TreeGrow, neither
  51. with your name nor mine. Sourcefiles are included for learning purpose
  52. only. If you have any suggestions or bug reports, please send me the
  53. corrected code.
  54.  
  55. ---------------------------------------------------------------------------
  56.  
  57.                 CONTACT ADDRESS
  58.                 ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  59.  
  60. PARADISE SOFT :     Benjamin Stegemann
  61.             Kiwittsmoor 32
  62.  
  63.             2000 Hamburg 62
  64.             Germany
  65.  
  66.  
  67. ---------------------------------------------------------------------------
  68.  
  69.                   ABOUT
  70.                   ¯¯¯¯¯
  71.  
  72. TreeGrow is a program which generates quasifractal trees or plants. Since
  73. only a couple interations are done, they are not really fractal. I found
  74. the idea in "Spectrum der Wissenschaft", the german release of "Scientific
  75. American".
  76.  
  77. The interations are done on strings. The strings consist of eight different
  78. characters :
  79.  
  80.     - '0' : draw a line straight forward.
  81.     - '1' : like '0', but draws a leave at the end of the line.
  82.     - '2' : like '1', but with a red flower.
  83.     - '3' : like '1', but with a yellow flower.
  84.     - '\' : turn left and begin a new branch.
  85.     - '/' : turn right and begin a new branch.
  86.     - '[' : turn left or right and begin a new branch.
  87.     - ']' : finishes the actual branch and continues drawing where
  88.         the branch began.
  89.  
  90. At each interation '0', '1', '2' and '3' are replaced by a defined string.
  91. For example :
  92.  
  93.         '0' -> '1[0]1[0]0'
  94.         '1' -> '12'
  95.         '2' -> '2'
  96.         '3' -> '3'
  97.  
  98. If the initializer was '01' the first generations will be :
  99.  
  100.         '0        1'
  101.  
  102.          |      |
  103.          V      V
  104.  
  105.         '1[0]1[0]012'
  106.  
  107. The secons generation will be :
  108.  
  109.     '1 [0        ]1 [0        ]0        1 2'
  110.  
  111.      |    |      |  |           |    | |
  112.      V    V      V  V           V    V V
  113.  
  114.     '12[1[0]1[0]0]12[1[0]1[0]0]1[0]1[0]0122'
  115.  
  116. and so on...
  117.  
  118. As you can see, after a few generations the strings becomes quite large !
  119. If the specified number of generations are done, the tree will be drawn.
  120. The best way of understanding this procedure is simply trying it.
  121.  
  122.             LEARNING BY DOING !!
  123.  
  124. ---------------------------------------------------------------------------
  125.  
  126.                   INSTRUCTIONS
  127.                   ¯¯¯¯¯¯¯¯¯¯¯¯
  128.  
  129. When you start TreeGrow a window will be opened and the library will be
  130. loaded. There are several gadgets visible in the window :
  131.  
  132. 'Init' : Here you enter the initializer.
  133.  
  134. '0 ->' : The string which replaces a '0' in each interation.
  135.  
  136. '1 ->' : The string which replaces a '1' in each interation.
  137.  
  138. '2 ->' : The string which replaces a '2' in each interation.
  139.  
  140. '3 ->' : The string which replaces a '3' in each interation.
  141.  
  142. 'Size' : The length in pixel of the first line.
  143.  
  144. 'Rate' : The percentage how long will be the next drawn line. If you enter
  145.       '100' every line will be as long as in 'Size' specified. With
  146.       '50' every line will be halve as long (50%) as the previous line.
  147.  
  148. 'Angle' : The range of the angle which is used, when an '\', '/' or '['
  149.       occures. The actual angle is a random value in this range. The
  150.       values are entered in degree. '30 to 40' turns a rondom angle
  151.       between 30 and 40 degrees to the left or right.
  152.  
  153. 'Generations' : The number of generations which are created, before the
  154.       tree is drawn.
  155.  
  156. 'Start' : Start the generation and drawing of the tree. A highres-interlace
  157.       screen will be opened and the tree will be drawn. Press the right
  158.       mousebutton to interrupt the drawing. If the drawing is completed
  159.       press the left mousebutton to return to the main window.
  160.  
  161. 'Save' : If there is already a drawn tree, you can save it using this
  162.       gadget. The file is a standart IFF file.
  163.  
  164. 'Name' : If you want to add the actual tree to the library, you have to
  165.       enter it's name in this gadget.
  166.  
  167. 'Save' : Save the library to the current directory. When you exit TreeGrow
  168.       the library won't be saved !!
  169.  
  170. 'Add' : Add the actual tree to the library. the containings of all gadgets
  171.       are saved.
  172.  
  173. 'Del' : Remove the highlighted tree in the list below these gadgets from
  174.       the library. BE CAREFUL !! Select the name using the two arrows.
  175.  
  176. 'Use' : Load the parameters of the highlighted tree in the list into the
  177.       gadgets.
  178.  
  179. ---------------------------------------------------------------------------
  180.  
  181.                 INSTALL LIBS
  182.                 ¯¯¯¯¯¯¯¯¯¯¯¯
  183.  
  184. TreeGrow needs some libraries to run. These are
  185.  
  186.     - ilbm.library
  187.     - req.library
  188.     - mathieeesingbas.library
  189.     - mathieeesingtrans.library
  190.  
  191. If they are not already in the current LIBS: directory TreeGrow won't
  192. start. Start InstallLibs to copy them to the LIBS: directory.
  193.  
  194. ---------------------------------------------------------------------------
  195.  
  196.  
  197.                 Pink says : "Goodbye.."
  198.  
  199.                             21-Dec-1992  Hamburg
  200.  
  201.